home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / rfw_v110.arc / RFWDOCEN.DOC < prev    next >
Text File  |  1991-04-23  |  48KB  |  932 lines
  1. ╔══════════════════════════════            ┌─────────────────┐
  2. ║ RFC/W     Remote Access                  │    D.I.S.P.     │────┐
  3. ║           Windowed file-list             │                 │░░░░│
  4. ╟──────────────────────────────            │                 │░░░░│
  5. ║ (c) 1991  Robert W.van Hoeven            │ Dutch           │░░░░│
  6. ╟──────────────────────────────            │   Independent   │░░░░│
  7. ║ Release : 1.10                           │     ShareWare   │░░░░│
  8. ║ Rel.Date: 14th April 1991                │       Programmer│░░░░│
  9. ╠══════════════════════════════            └─────────────────┘░░░░│
  10. ║                                          |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ RFC.EXE / RFCCFG.EXE                   |    └─────────────────┘
  12. ║ │ RFW.EXE / RFWCFG.EXE                   |       ┌─────┐        |
  13. ║ │                                        |       │░░░░░│        |
  14. ║ │                                        |       └──┬──┘        |
  15. ║ │ Lines starting with '│' are            |     ┌────┴────┐      |
  16. ║ │ changes from version 1.04 !            ------││││││ ═══│-------
  17. ║                                                └─────────┘
  18. ╠═══════════════════════════════
  19. ║ Address: Robert W. van Hoeven
  20. ║          PO. Box 131
  21. ║          1170 AC  Badhoevedorp
  22. ║          Nederland / Holland
  23. ╚═══════════════════════════════
  24.  
  25.  ┌───────┬─────────────────────────────────────────────────────────────┐
  26.  │   0   │ Table of contents                                           │
  27.  └───────┴─────────────────────────────────────────────────────────────┘
  28.  
  29.  1 ----    General information
  30.   1.1      Copyrights and License Agreement
  31.   1.2      Newer versions and contacting the author
  32.  
  33.  2 ----    Package description and requirements
  34.   2.1      Preface
  35.   2.2      Requirements
  36.   2.3      Included files
  37.   2.4      History
  38.   2.5      Multitaskers
  39.  
  40.  3 ----    Installation description
  41.   3.1      Installation
  42.   3.2      Install RFC
  43.   3.3      Install RFW
  44.   3.4      BBS menu options
  45.  
  46.  4 ----    Runtime information
  47.   4.1      Calling RFW
  48.   4.2      FileDoor/DISP-compatible tag-file <tm>
  49.  
  50.  5 ----    Version information and credits
  51.   5.1      The BETA-team
  52.   5.2      Credits
  53.   5.3      Version history
  54.   5.4      Copyright, Trademarks
  55.  
  56.  ┌───────┬─────────────────────────────────────────────────────────────┐
  57.  │   1   │ General information                                         │
  58.  └───────┴─────────────────────────────────────────────────────────────┘
  59.  
  60. │1.1 Copyrights and License Agreement
  61. │────────────────────────────────────
  62. │- Users of the RFW-package must accept this disclaimer of warranty:
  63. │
  64. │- The RFW-package is supplied as is.  The author disclaims all
  65. │  warranties, expressed or implied, including, without limitation,
  66. │  the warranties of merchantability and of fitness for any purpose.
  67. │  The author assumes no liability for damages, direct or consequential,
  68. │  which may result from the use of the RFW-package;
  69. │
  70. │- The RFW-package is a "shareware program" and is provided at no charge
  71. │  to the user for evaluation.  Feel free to share it with your friends,
  72. │  but please do not give it away altered or as part of another system.
  73. │  The essence of "user-supported" software is to provide personal
  74. │  computer users with quality software without high prices, and yet to
  75. │  provide incentive for programmers to continue to develop new products.
  76. │
  77. │- If you find this program useful and find that you are using and
  78. │  continue the use of the RFW-package after a 30 days trial period,
  79. │  you must register the RFW-package as described below;
  80. │
  81. │- Non-commercial users will get a license for the usage of RFW by
  82. │  sending a postcard or letter as registration. Non-commercial users
  83. │  are FREE to use RFW on their system(s) without paying any fee. A
  84. │  'closed BBS' (a BBS where users have to pay for using the BBS) is
  85. │  NOT a non-commercial user;
  86. │
  87. │- Closed BBS's (a BBS where you have to pay to get access to the
  88. │  BBS) can get a Closed-BBS license for a small amount of money.
  89. │  All users that are registered before April 1th 1991 (postcards,
  90. │  letters or NetMail received by me before April 1th 1991) and that
  91. │  run a Closed BBS, get their license for free. See REGISTER.RFW
  92. │  for details;
  93. │
  94. │- Commercial usage of RFW will cost somewhat more. A company using
  95. │  RFW needs a commercial license. See REGISTER.RFW for details;
  96. │
  97. │- The registration of the RFW-package will license ONE copy for use on
  98. │  any computer at any one time, as long as the usage confirms to the
  99. │  type of registration you have done (so NON-commercial usage when you
  100. │  have a non-commercial license);
  101. │
  102. │- Anyone distributing the RFW-package for any kind of remuneration must
  103. │  first contact the Author at the address above for authorization.
  104. │
  105. │- You are encouraged to pass a copy of the RFW-package along to your
  106. │  friends for evaluation.  Please encourage them to register their
  107. │  copy if they find that they can use it;
  108. │
  109. │- Support on RFW, is available by means of written letters or by
  110. │  entering the international echomail area DISP;
  111. │
  112. │- Problems and suggestions can be entered in the FidoNet <tm> Echomail
  113. │  conference <tm> called DISP (international). Entering this echo does
  114. │  not exclude you of the duty to register the RFW-package, though users
  115. │  who evaluate the product can enter the echo for questions;
  116. │
  117. │- The RFW-package, all programs, the documentation and support-files is
  118. │  copyrighted 1991 by Robert W. van Hoeven, PO. Box 131, Badhoevedorp
  119. │  1170AC, Holland. All rights are reserved. You may copy this package
  120. │  for backup purposes. Also you may copy and share unmodified copies of
  121. │  the whole package, providing that the copyright notice is reproduced
  122. │  and included on all copies.
  123. │  Excluded from this statement are the support-files written by other
  124. │  authors. Please refer to the documentation of these programs for
  125. │  copyrights and license agreements;
  126. │
  127. │- It is forbidden to modify, adapt, translate, reverse engineer, de-
  128. │  compile and/or disassemble the software in the RFW-package. Patching
  129. │  the medium at places that carry the software is seen as a program
  130. │  change and is also forbidden;
  131. │
  132. │- Performing any of the illegal actions as stated in the previous
  133. │  lines, is a theft and no fair play to the author and, more important,
  134. │  to the registered users;
  135. │
  136. │- Bulletin Board Systems that distribute the RFW package can convert
  137. │  the WHOLE package to any archive-system they like but all original
  138. │  files must be included in the new archive. The RFW-package on the
  139. │  Bulletin Board can contain at the most 2 extra files. These files
  140. │  can only be a commercial for that Bulletin Board and/or validation
  141. │  data that is presented as a service to all users and shall have no
  142. │  other functions;
  143. │
  144. │- After the normal trial period of 30 days, you must register the soft-
  145. │  ware (see REGISTER.RFW) or you must remove it from your PC;
  146. │
  147. │- Comments, suggestions and bug reports are welcome and will be answered
  148. │  as soon I have the time to do so. You can send me a letter of leave a
  149. │  NetMail <tm> message named to Rob Van.hoeven (mind the point) on node
  150. │  2:512/100 (RA Support, Monster, Holland, SysOp is Reinier de Groot).
  151. │  When you want to send me normal mail, address it to:
  152. │  Robert W. van Hoeven, PO. Box 131, 1171 AC Badhoevedorp, Holland;
  153. │  Also you can enter messages in the FidoNet <tm> DISP Echomail <tm>
  154. │  area;
  155. │
  156. │
  157. │1.2 Newer versions and contacting the author
  158. │────────────────────────────────────────────────────────────────────────
  159. │The newest version of RFW is always available at the DISP-HQ on node
  160. │2:512/100. RFW is also distributed thru a number of DISP support nodes.
  161. │You can obtain RFW in four different ways:
  162. │
  163. │- Logging on at DISP-HQ or a support node
  164. │
  165. │  All zones :  2:512/100 (Multiline Paradise NL  )       DISP-HQ
  166. │                         (Sysop: Reinier de Groot)
  167. │
  168. │  For zone 1:  1:203/988 (Amber Shadow       USA )       Support & beta
  169. │                         (Sysop: Dave Overton    )
  170. │
  171. │  For zone 2:  2:280/216 (Sirex              NL  )       Support & beta
  172. │                         (Sysop: Gerry Ulrich    )
  173. │               2:242/4   (GOLEM    Meerbusch FRG )       Support & beta
  174. │                         (Sysop: Hanstheo Wolf   )
  175. │               2:244/12  (FunBoard Felbert   FRG )       Support & beta
  176. │                         (Sysop: Dirk Astrath    )
  177. │
  178. │  The BBS's above will always have the most current version of RFW
  179. │  available. Also, in some cases, it is possible to request the
  180. │  newest RFW with a standard file-request (ask the SysOp in question).
  181. │  On 2:512/100 you can use RFWNEW as magical name to Freq. the newest
  182. │  version.
  183. │  The actual DISP-HQ is point 2:512/100.5, but this is a closed system
  184. │  and can not be accessed from the 'outside'). You CAN address netmail
  185. │  to this point though !
  186. │
  187. │- Logging on to a SDS node
  188. │  MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20 and
  189. │  so on) and majors (14.01, 15.01 and so on) are submitted to the SDS
  190. │  distribution point in Holland;
  191. │
  192. │- Logging on to your own BBS;
  193. │  Chances are, that you will find an older version (international
  194. │  users) because it will take some time for the new version to
  195. │  'bleed' thru the net;
  196. │
  197. │- Update service;
  198. │  You can enter a special update service (read REGISTER.RFW).
  199. │
  200. │
  201. │If you think you have found problems in RFW, or in any other case,
  202. │you wish to contact the author, you can send me:
  203. │
  204. │- A letter to the address you can find in the header of this file;
  205. │- A NetMail <tm> message to Rob Van.hoeven (please mind the point
  206. │  between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  207. │- A Message in the FidoNet <tm> DISP echomail <tm> area;
  208.  
  209.  ┌───────┬─────────────────────────────────────────────────────────────┐
  210.  │   2   │ Package description and requirements                        │
  211.  └───────┴─────────────────────────────────────────────────────────────┘
  212.  
  213.  2.1 Preface
  214.  ────────────────────────────────────────────────────────────────────────
  215.  This program is developed as a stand-alone file-lister with windowing
  216.  (full screen) capacity. It does NOT depend on the QF series, like the
  217. │QFF program. It can only be used in a Remote Access <tm>, QuickBBS <tm>
  218. │or SBBS <tm> environment.
  219.  
  220.  RFW will be VERY effective in multi-tasking environments and on BBS's
  221.  with a large number of files/file area's because RF will not (each
  222.  time it is called) search in the area's itself, but uses a pre-com-
  223.  piled list. Access to this list is at (almost) optimum speed.
  224.  
  225.  
  226.  2.2 Requirements
  227.  ────────────────────────────────────────────────────────────────────────
  228.  RFW requires:      - PC XT/AT/386/486
  229. │                   - At least 160K free memory;
  230.                     - DOS 3.xx and higher;
  231.                       (tested with 4Dos 3.02, should work with lower
  232.                       versions);
  233.                     - HDU optional
  234.                     - A Bulletin Board System. Directly supported are
  235.                       the QuickBBS, SBBS and Remote Access types;
  236.  
  237.  
  238.  2.3 Included files
  239.  ────────────────────────────────────────────────────────────────────────
  240. │The package includes : RFW.EXE        The main lister program
  241. │                       RFWCFG.EXE     Configuration program for RFW
  242. │                       RFC.EXE        The main compiler program
  243. │                       RFWCFG.EXE     Configuration program for RFC
  244. │                       RFWHLP.ANS     Example help-file for ANSI users
  245. │                       RFWHLP.ASC     Example help-file for ASCII users
  246.  
  247.  
  248.  2.4 History
  249.  ────────────────────────────────────────────────────────────────────────
  250.  My current file-lister (QFF) is only usable along with the complete
  251.  QF-series programs (500K). Some people don't use the main programs
  252.  on this series (a pitty) but only QFF. To download the whole QF-series
  253.  only for a file-list is somewhat overdone.
  254.  
  255.  I have created a full-screen file-list in the QF-series (QFW) but this
  256.  program can only execute at fast speed with QF's (2.xx) database struc-
  257.  ture and this version is not released yet. On a normal FILES.BBS, QFW
  258.  will give a very poor performance but this program (RFW) uses a pre-
  259.  compiled database and selects the lines to be displayed from this
  260.  file.
  261.  
  262.  I find this program a nice 'intermediate' program between QFF V 1.57
  263.  and the up comming QFD V 2.01. QFV/D V 2.01 will take some months to
  264.  be released.
  265.  
  266.  RFC/W keeps up the FILES.BBS compatibility AND the extension that QFV
  267.  and QFC can create (extra comment-lines on files).
  268.  
  269.  
  270.  2.5 Multitaskers
  271.  ────────────────────────────────────────────────────────────────────────
  272.  RFW is aware of multitaskers. When SHARE is loaded (and even when it
  273.  isn't), RFW will share the pre-compiled database with other (concur-
  274.  rent) RFW tasks. RFC (the compiler) will use the database on an exclu-
  275.  sive basis, so you need to run the compiler somewhere in an event.
  276.  
  277.  ┌───────┬─────────────────────────────────────────────────────────────┐
  278.  │   3   │ Installation description                                    │
  279.  └───────┴─────────────────────────────────────────────────────────────┘
  280.  
  281.  3.1 Installation
  282.  ────────────────────────────────────────────────────────────────────────
  283.  Installation is made simple. You must use the two configuration pro-
  284.  programs to make a patched version of the original programs. You can
  285.  use the CFG-programs to alter the current version without having to
  286. │install options again and you can use the main programs to type-out
  287. │a new configuration when a new version is released.
  288.  
  289.  Installation is as follows:
  290.  
  291.  - Put RFC.EXE somewhere on your hard-disk;
  292.  - Put RFCCFG.EXE in the same directory;
  293.  - Change to this directory and run RFCCFG (see below);
  294.  - Put RFW.EXE somewhere on your hard-disk;
  295. │- Put the RFWHLP.??? files somewhere on you harddisk, on the DOS-path
  296. │  or along with RFW.EXE in the same directory (access depends on the
  297. │  installation of RFW0;
  298.  - Put RFWCFG.EXE in the same directory;
  299.  - Change to this directory and run RFWCFG (see below);
  300.  - Add RFC.EXE somewhere in your batch file that runs your BBS
  301.    (an event) and/or behind the program that you use to alter
  302.    the FILES.BBS files;
  303.  - For fastest access you can put the compiled files somewhere
  304.    on a RAM-disk, but make sure you created these files first on
  305.    a fixed disk;
  306.  - Put RFW.EXE in a type 7 at locations where you want to replace
  307.    your current files-list with this program (so at files-list,
  308.    new-files, keyword-search and file-search) as described be-
  309.    low;
  310.  
  311.  RFC.EXE makes two files (a compiled file-list and a compiled area
  312.  list). RFC can (optionally) create temporary files first and when
  313.  ready, RFC will move these files over the old version. In this
  314.  case you can run RFC almost any time, also when the BBS if active
  315.  and users use the file-list.
  316.  
  317.  RFC will take the area-file and compiles a list with records to be dis-
  318.  played later. All extra info (like security level, area name, flags and
  319. │so on) is imported into the compiled list. Also CD-ROM (alternate files
  320. │area's) are supported in RA 1.xx and RA 0.xx mode.
  321.  
  322.  When installing for the first time, you must run RFC from the command-
  323.  line first to get a database. Later, in the event, a new list will be
  324.  created from inside the batch-file or after you have altered the files
  325.  in FILES.BBS.
  326.  
  327.  RFW takes the compiled lists and creates a sub-list (depending on the
  328.  task-number) in memory, EMS, XMS or disk, depending on the resources
  329.  and the length of the list. The creation of a sub-list is needed be-
  330.  cause only at execution-time of RFW, RFW knows the security level and
  331.  flags (and chosen option for that matter) and creates the sub-list
  332.  with this information. BUT only the compiled list is accessed on a
  333.  very fast speed and not all individual files each. It should be clear
  334.  that RFW.EXE points to the same files as RFC.EXE has created, also
  335.  ensure that the files are compiled at least every day otherwise your
  336.  users won't see new files for a long, long time.
  337.  
  338.  
  339.  3.2 Install RFC
  340.  ────────────────────────────────────────────────────────────────────────
  341.  Both RFC and RFW have to be installed first, because it is almost
  342.  sure that you can not use the supplied defaults (except the colors).
  343.  
  344.  When you start RFCCFG.EXE, you will get the following questions:
  345.  
  346.  
  347. │╒══════════════════════════════════════════════════════════════════════════════╕
  348. ││ You can now select the type of BBS you run RFC on. Currently there           │
  349. ││ are four types supported, QuickBBS <tm>, Remote Access 0.xx /1.xx            │
  350. ││ and SBBS.                                                                    │
  351. ││ NOTE : Use <ESC> to abort installation and read documentation !!             │
  352. ││                                                                              │
  353. ││ You can enter the following types:  1 - QuickBBS <tm>                        │
  354. ││                                     2 - Remote Access <tm> Rel 0.xx          │
  355. ││                                     3 - Remote Access <tm> Rel 1.xx          │
  356. ││                                     4 - SBBS <tm>                            │
  357. ││                                                                              │
  358. ││ Type of BBS RFC will assume                      : 3                         │
  359. │╘══════════════════════════════════════════════════════════════════════════════╛
  360. │RFC needs to know the type of BBS you are running. This information is
  361. │needed to read the proper area-file and it's layout (FILES.RA in two
  362. │flavours, FLSEARCH.BBS). It must be the same type you supply to RFWCFG.
  363.  
  364.  ╒══════════════════════════════════════════════════════════════════════════════╕
  365.  │ Drive, path and name for area-file to use        : D:\BBS\RAX\FILES.RA       │
  366.  ╘══════════════════════════════════════════════════════════════════════════════╛
  367.  This field must point to (one of your) area-files. RFC will take this
  368. │file to create the compiled list. In general, use the FILES.RA for a
  369. │Remote Access <tm> BBS or the FLSEARCH.CTL for both QuickBBS <tm> or
  370. │SBBS <tm>.
  371. │
  372. │╒══════════════════════════════════════════════════════════════════════════════╕
  373. ││ Drive, path to alternate FILES.x files (CD-ROM)  : D:\BBS\RAX\FIL\           │
  374. │╘══════════════════════════════════════════════════════════════════════════════╛
  375. │This question will only be asked when you use a RA 1.xx (and higer)
  376. │type of BBS (not for RA 0.xx). This directory must point to the same
  377. │directory you have installed with RACONFIG and that point to the
  378. │directory where alternate FILES.n (where n is the file-area number)
  379. │are stored;
  380.  
  381.  ╒══════════════════════════════════════════════════════════════════════════════╕
  382.  │ Drive, path and name for compiled file      (CMP): D:\BBS\RAX\RFC.CMP        │
  383.  ╘══════════════════════════════════════════════════════════════════════════════╛
  384.  This field must contain the name of the compiled files-list. This field
  385.  must point to the same file as supplied in RFW.EXE. You must supply the
  386.  full drive, path and name otherwise RFCCFG.EXE will complain.
  387.  
  388.  ╒══════════════════════════════════════════════════════════════════════════════╕
  389.  │ Drive, path and name for compiled area-file (ARE): D:\BBS\RAX\RFC.ARE        │
  390.  ╘══════════════════════════════════════════════════════════════════════════════╛
  391.  This field must contain the name of the compiled area-list. This field
  392.  must point to the same file as supplied in RFW.EXE. You must supply the
  393.  full drive, path and name otherwise RFCCFG.EXE will complain.
  394.  
  395.  ╒══════════════════════════════════════════════════════════════════════════════╕
  396.  │ Use original files only a short moment    [Y/N]  : Y                         │
  397.  ╘══════════════════════════════════════════════════════════════════════════════╛
  398.  If you supply a 'Y', RFC will compile $$$RC$$$.CMP and $$$RC$$$.ARE in
  399.  the current directory first and after compilation is ready, it will
  400.  delete the original files and move these files to the right place and
  401.  with the right name. Make sure you have enough space on your hard-disk
  402.  because you need the full amount of space the compiled files use,twice.
  403.  
  404.  
  405.  3.3 Install RFC
  406.  ────────────────────────────────────────────────────────────────────────
  407.  Both RFC and RFW have to be installed first, because it is almost
  408.  sure that you can not use the supplied defaults (except the colors).
  409.  
  410.  When you start RFWCFG.EXE, you will get the following questions:
  411.  
  412. │╒══════════════════════════════════════════════════════════════════════════════╕
  413. ││ You can now select the type of BBS you run RFW on. Currently there           │
  414. ││ are four types supported, QuickBBS <tm>, Remote Access 0.xx /1.xx            │
  415. ││ and SBBS.                                                                    │
  416. ││ NOTE : Use <ESC> to abort installation and read documentation !!             │
  417. ││                                                                              │
  418. ││ You can enter the following types:  1 - QuickBBS <tm>                        │
  419. ││                                     2 - Remote Access <tm> Rel 0.xx          │
  420. ││                                     3 - Remote Access <tm> Rel 1.xx          │
  421. ││                                     4 - SBBS <tm>                            │
  422. ││                                                                              │
  423. ││ Type of BBS RFW will assume                      : 3                         │
  424. │╘══════════════════════════════════════════════════════════════════════════════╛
  425. │The same question as with RFCCFG.EXE. Look into the previous chapter !
  426.  
  427.  ╒══════════════════════════════════════════════════════════════════════════════╕
  428.  │ Drive, path and name for compiled file      (CMP): D:\BBS\RAX\RFC.CMP        │
  429.  ╘══════════════════════════════════════════════════════════════════════════════╛
  430.  Must be the same name as you supplied in RFCCFG.EXE.
  431.  
  432.  ╒══════════════════════════════════════════════════════════════════════════════╕
  433.  │ Drive, path and name for compiled area-file (ARE): D:\BBS\RAX\RFC.ARE        │
  434.  ╘══════════════════════════════════════════════════════════════════════════════╛
  435.  Must be the same name as you supplied in RFCCFG.EXE.
  436.  
  437.  ╒══════════════════════════════════════════════════════════════════════════════╕
  438.  │ Drive, path and name for ANS help-file or EMPTY  :                           │
  439.  ╘══════════════════════════════════════════════════════════════════════════════╛
  440. │You must use your own HELP-files. This option must point to the name
  441. │location of the help-file for ANSI-users. If you leave this option
  442. │empty, RFW will search for RFWHLP.ANS (or RFWHLP.ASC) in one of the
  443. │following locations:
  444. │- Current directory;
  445. │- Directory where RFW.EXE is stored;
  446. │- Dos-path;
  447. │If an ANS-file is not present, RFW will try to search for an ASC-file.
  448. │
  449. │╒══════════════════════════════════════════════════════════════════════════════╕
  450. ││ Drive, path and name for ASC help-file or EMPTY  :                           │
  451. │╘══════════════════════════════════════════════════════════════════════════════╛
  452. │See previous question.
  453. │
  454. │╒══════════════════════════════════════════════════════════════════════════════╕
  455. ││ Drive and path to location of tag-file or EMPTY  : D:\BBS\RAX                │
  456. │╘══════════════════════════════════════════════════════════════════════════════╛
  457. │With the release of FileDoor 2.xx a new type of file is introduced to
  458. │support the tag-function of FileDoor. This FileDoor/DISP-compatible
  459. │file must be created in a certain directory. This must be the same as
  460. │your FileDoor.CFG configuration points to. If you leave the entry empty
  461. │RFW will not use tagging at all.
  462.  
  463.  ╒══════════════════════════════════════════════════════════════════════════════╕
  464.  │ Do you want scrolling and no clear-screen [Y/N]  : N                         │
  465.  ╘══════════════════════════════════════════════════════════════════════════════╛
  466.  You can choose from either two options:
  467.  - The screen is will clear before the next screen is drawn. This is
  468.    the fastest option and most SysOp's will use it I imagine. In this
  469.    case you supply a 'N';
  470.  - The screen is redrawn OVER the current screen. This is the same as
  471.    a normal DOS application but because of the low speed (2400 and
  472.    less) this can look a bit messy. In this case you use a 'Y';
  473.  
  474.  ╒══════════════════════════════════════════════════════════════════════════════╕
  475.  │ Do you want a top-ruler (start of list)   [Y/N]  : Y                         │
  476.  ╘══════════════════════════════════════════════════════════════════════════════╛
  477.  You can choose to display 'TOP OF LIST' as a ruler. If you don't want
  478.  this, you must supply 'N';
  479.  
  480.  ╒══════════════════════════════════════════════════════════════════════════════╕
  481.  │ Do you want a bottom-ruler (end of list)  [Y/N]  : Y                         │
  482.  ╘══════════════════════════════════════════════════════════════════════════════╛
  483.  You can choose to display 'BOTTOM OF LIST' as a ruler. If you don't
  484.  want this, you must supply 'N';
  485.  
  486.  ╒══════════════════════════════════════════════════════════════════════════════╕
  487.  │ Only use specified /A for search and new  [Y/N]  : N                         │
  488.  ╘══════════════════════════════════════════════════════════════════════════════╛
  489.  Normally you only have to supply /A when you use RFW as a multiple
  490.  choice list ('do you want to list, search, list new files') or when
  491.  you only want to list files.
  492.  If you want the /A also to work WITHIN newfiles and the search, you
  493.  must supply a 'Y'. In this case a search will only be conducted in
  494.  the area you supplied with /A. The same goes for new-files. By default
  495.  you should use 'N' in this option unless you know what you are doing.
  496.  
  497.  ╒══════════════════════════════════════════════════════════════════════════════╕
  498.  │ Date format to use (use d/D/m/M/y/Y and sep.char): mm/dd/yy                  │
  499.  ╘══════════════════════════════════════════════════════════════════════════════╛
  500.  You can supply the date-format in the files-list. Any combination
  501.  (within 8 characters and using the supplied characters) is valid
  502.  (yy/mm/dd, mm-dd-yy, yy:dd:mm and so on). Be sure to include 8
  503.  characters, otherwise the file-list can be somewhat shifted at
  504.  several places (only when you use multiple line comments).
  505.  A capital character means 'suppress leading zero' a lower-case
  506.  character means 'display leading zero'.
  507.  
  508.  ╒══════════════════════════════════════════════════════════════════════════════╕
  509.  │ Color for headers    ( low)                      : <TEST>       Blink: N     │
  510.  │ Color for headers    (high)                      : <TEST>       Blink: N     │
  511.  │ Color for header-1                               : <TEST>       Blink: N     │
  512.  │ Color for header-2                               : <TEST>       Blink: N     │
  513.  │ Color for header-3                               : <TEST>       Blink: N     │
  514.  │ Color for header-4                               : <TEST>       Blink: N     │
  515.  │ Color for header-5                               : <TEST>       Blink: N     │
  516.  │ Color for top-ruler                              : <TEST>       Blink: N     │
  517.  │ Color for bottom-ruler                           : <TEST>       Blink: N     │
  518.  │ Color for art-work/comments                      : <TEST>       Blink: N     │
  519.  │ Color for filename                               : <TEST>       Blink: N     │
  520.  │ Color for filesize                               : <TEST>       Blink: N     │
  521.  │ Color for filedate                               : <TEST>       Blink: N     │
  522.  │ Color for file-comment                           : <TEST>       Blink: N     │
  523.  │ Color for new files                              : <TEST>       Blink: M     │
  524.  │ Color for error messages                         : <TEST>       Blink: N     │
  525.  │ Color for area-separators                        : <TEST>       Blink: N     │
  526.  │ Color for help-line  ( low)                      : <TEST>       Blink: N     │
  527.  │ Color for help-line  (high)                      : <TEST>       Blink: N     │
  528. ││ Color for tag-option letter                      : <TEST>       Blink: N     │
  529. ││ Color for tagged file char                       : <TEST>       Blink: Y     │
  530.  ╘══════════════════════════════════════════════════════════════════════════════╛
  531.   You can alter ANY (except the local information window) color in the
  532.   list. For every option you can select one of 128 different color
  533.   combinations. Use N to see the next, P to see the previous and T to
  534.   go to the first (black) color in the list.
  535.   Use ENTER to select the color and then use 'Y' or 'N' to select if
  536.   you want this field to blink !
  537.  
  538.  
  539.  3.4 BBS menu options
  540.  ────────────────────────────────────────────────────────────────────────
  541.  RFW needs to be installed in a type 7 (or 15) in the BBS menu(s). RFW
  542.  needs some command-line options to do its work. These are:
  543.  
  544.  ╒══════════════════════════════════════════════════════════════════════════════╕
  545.  │ /A[area to display]                                                          │
  546.  ╘══════════════════════════════════════════════════════════════════════════════╛
  547.  /A is only needed with /LF but can always be supplied (if this makes
  548.  it more transparent to you). Only when you select a special option in
  549.  RFWCFG.EXE, /A has a meaning with all other options than /LF (see
  550.  above). You must include the same path as you have supplied in the
  551.  FILES.RA file. So if all your paths are without a drive-letter, you
  552.  must also leave the drive-letter out overhere. It is better to use
  553.  the standard RA <tm> option *0 because this is the same path/area as
  554.  in FILES.RA. So by default, use /A*0 in your type 7 or 15 menu record.
  555.  (*0 works only with RA 0.03 and up !).
  556.  
  557.  ╒══════════════════════════════════════════════════════════════════════════════╕
  558.  │ /N[line]                                                                     │
  559.  ╘══════════════════════════════════════════════════════════════════════════════╛
  560.  This option is important when you run a multi-line BBS. Include /N*N
  561.  in your type 7 or 15 if this is the case. If you forget this option,
  562.  two concurrent RFW programs, could use the same EMS/Disk-space when
  563.  they are running, causing a mess on the screen and a hangup of your
  564.  machine.
  565.  
  566.  ╒══════════════════════════════════════════════════════════════════════════════╕
  567.  │ /LF                               (*) see below                              │
  568.  ╘══════════════════════════════════════════════════════════════════════════════╛
  569.  When you supply this option, RFW will get into 'list files' mode and
  570.  needs a /A to perform its task. Only files in the supplied area are
  571.  listed.
  572.  
  573.  ╒══════════════════════════════════════════════════════════════════════════════╕
  574.  │ /NF                               (*) see below                              │
  575.  ╘══════════════════════════════════════════════════════════════════════════════╛
  576.  When you supply this option, RFW will get into 'list new files' mode.
  577.  /A is not needed unless in special cases (see RFWCFG.EXE).
  578.  
  579.  ╒══════════════════════════════════════════════════════════════════════════════╕
  580.  │ /KS                               (*) see below                              │
  581.  ╘══════════════════════════════════════════════════════════════════════════════╛
  582.  When you supply this option, RFW will get into 'search for keyword'
  583.  mode. /A is not needed unless in special cases (see RFWCFG.EXE).
  584.  
  585.  ╒══════════════════════════════════════════════════════════════════════════════╕
  586.  │ /FS                               (*) see below                              │
  587.  ╘══════════════════════════════════════════════════════════════════════════════╛
  588.  When you supply this option, RFW will get into 'search for files'
  589.  mode. /A is not needed unless in special cases (see RFWCFG.EXE).
  590.  
  591.  ╒══════════════════════════════════════════════════════════════════════════════╕
  592.  │ /KF                               (*) see below                              │
  593.  ╘══════════════════════════════════════════════════════════════════════════════╛
  594.  When you supply this option, RFW will ask a question to the user if
  595.  she/he want to go into search-keyword or search-files mode.
  596.  /A is not needed unless in special cases (see RFWCFG.EXE).
  597.  
  598. │╒══════════════════════════════════════════════════════════════════════════════╕
  599. ││ /ASC                                                                         │
  600. │╘══════════════════════════════════════════════════════════════════════════════╛
  601. │You will force RFW to use ASCII displays when you insert this option !
  602. │
  603. │╒══════════════════════════════════════════════════════════════════════════════╕
  604. ││ /CFG                                                                         │
  605. │╘══════════════════════════════════════════════════════════════════════════════╛
  606. │When /CFG is used on either RFC or RFW, the program will write a
  607. │configuration-file. This file can be used by RFWCFG and RFCCFG to
  608. │add the old information to any new release. RFC or RFW will stop
  609. │after the .CFG file is written;
  610.  
  611.  ╒══════════════════════════════════════════════════════════════════════════════╕
  612.  │ (*) now for something special                                                │
  613.  ╘══════════════════════════════════════════════════════════════════════════════╛
  614.  If you supply neither /LF, /NF, /KF, /KS or /FS, RFW will ask the user
  615.  what to do. The user can now select from any of the option and RFW will
  616.  perform this task. Because the user (at any time in the list) can force
  617.  RFW to go back to the start (to ask a new mask or date for new-files),
  618.  this is a powerful option. You only need one menu-item to do all file
  619.  (list) access in one strike. Obvious, one of the following versions will
  620.  also include a 'Change area option'.
  621.  
  622.  ┌───────┬─────────────────────────────────────────────────────────────┐
  623.  │   4   │ Runtime information                                         │
  624.  └───────┴─────────────────────────────────────────────────────────────┘
  625.  
  626.  4.1 Usage of RFW
  627.  ────────────────────────────────────────────────────────────────────────
  628.  When RFW presents its list of files (if any), so after the questions
  629.  that RFW (optionally asks to the user), the user can do several
  630.  things. FIRST (and most important) is that the user must set his/hers
  631.  NUM-LOCK to on (also when running locally). If she/he forgets this,
  632.  nothing will happen unless 'Q', '?','N','T', [ENTER] or [ESC] is used.
  633.  
  634.  Next the user can use '7' (simulate of HOME) to go to the top of the
  635.  list. '1' (simulate of END) to go to the bottom of the list. These
  636.  two options can also be used to redraw the screen.
  637.  
  638.  '8' and '2' (simulate CRSR-UP and CRSR-DOWN) can be used to scroll
  639.  one line up or down at the time.
  640.  
  641.  '9' and '3' (simulate PGUP and PGDN) can be used to scroll one page
  642.  at up or down at the time.
  643.  
  644.  [ENTER] can also be used as a replacement of '3' (PGDN).
  645.  
  646.  [ESC] will terminate the execution.
  647.  
  648.  '?' or 'H' will force QFW to display its own help information or the
  649.  file you supplied with RWFCFG.EXE.
  650.  
  651.  'N' can be used to reset RFW without leaving the program. In all modes
  652.  except /LF, this option can be used to let the user enter a new
  653.  selection (new search-mask or new date for new-files). If RFW runs
  654.  without /LF, /NF, /KS, /FS and /KF, 'N' will force RFW to go back to
  655.  the first question to ask the user the mode to run in.
  656.  
  657. │'T' can be used to tag or untag files. When RFW starts, it will test
  658. │for the presence of a FileDoor/DISP-compatible tag-file. If this file
  659. │belongs to the user and was previously edited by RFW, the information
  660. │will be displayed to the user and the user can reuse (add/delete files
  661. │to the list) or delete the tag-file.
  662. │If RFW was not the last program that edited the tag-file, the user
  663. │can choose to terminate RFW or to delete the file.
  664. │If tagging is not set (e.g. RFW does not point to a directory that
  665. │will contain the tag-file), the user is left in peace and no questions
  666. │are asked.
  667. │With tagging, the user can tag/untag files from the list. Tagged
  668. │files will be stored in a list that can be used by FileDoor <tm> or
  669. │other 3th party vendor programs.
  670.  
  671.  At the local side, you can also enter any of the above keys AND you
  672.  can enter CTRL-T to toggle RFW's information window. If this window
  673.  is set to ON, RFW will re-display this window (only at the local side)
  674.  with every change of the screen. If you toggle this option OFF again,
  675.  you must wait until the user changes the screen before the window is
  676.  gone again.
  677.  
  678.  The user is able to enter any key while the screen is build. This
  679.  hot-key support looks much like the build-in hot-key support of
  680.  RA.
  681.  
  682.  RFW monitors the remaining time the user is allowed in the BBS, the
  683.  carrier (if carrier is lost, RFW will terminate and the BBS will take
  684.  over again) and if the user is not entering any key within 2 minutes.
  685.  
  686. │If you want to have current user information, you must hit the CTRL-T
  687. │button. This button toggles the status-display !
  688.  
  689.  
  690. │4.2 FileDoor/DISP-compatible tag-file <tm>
  691. │────────────────────────────────────────────────────────────────────────
  692. │With release 1.10, RFW contains a full FileDoor/DISP-compatibel tag-
  693. │file <tm> implementation. What does this mean.
  694. │
  695. │The user is able to tag (or untag for that matter) files that she/he
  696. │would like to select from the list that RFW presents. Tagging can be
  697. │done with the <T>-key. A file already tagged can be untagged, a file
  698. │that is not tagged can be tagged (so <T> works like a toggle).
  699. │
  700. │When the user terminates RFW, RFW will write a special kind of file.
  701. │This file is called the FileDoor/DISP-compatible tag-file. This file
  702. │has a uniform format and can be read by most door-like DISP programs
  703. │and (its primary reason of being there) by FileDoor <tm>. When the
  704. │FileDoor <tm> program detects such a tag-file, it will test if the
  705. │file belongs to the current user (if not, it will be deleted) and
  706. │the file will (or can) be used as input for the file-selection in-
  707. │side FileDoor (download/Bidirectional). RFW creates a so called auto-
  708. │tag file. This means that FileDoor will start reading the tag-file
  709. │without asking the user. The user is still able though, to select
  710. │or reject the presented choice.
  711. │
  712. │When RFW has created a tag-file and the user enters RFW again (while
  713. │there is still a tag-file from the same user), the user has the op-
  714. │tion to reuse the tag-file or to delete it. If the file is reused,
  715. │RFW will show all files already tagged before and will keep files
  716. │from other areas inside the tag-file. The user can now change the
  717. │tagging (set it to off) or add new files. Before termination, RFW
  718. │will merge the new results in the old tag-file. In this way, the
  719. │user can scroll thru various areas and can create a combined tag-
  720. │file that can be used with FileDoor (if autosearch is set to on).
  721. │Deleting the tag-file means that the old tag-file is flushed and
  722. │(optionally) a new one is created.
  723. │
  724. │When FileDoor <tm> has used the RFW tag-file, the auto-tag switch
  725. │is set to off. If the user enters FileDoor again, the tag-file must
  726. │be selected by hand (/TAG).
  727. │
  728. │A description of the FileDoor/DISP-compatible tag-file is included
  729. │in the supporting programs at the moment that the internal structure
  730. │is released for public usage. In this case a file called FDTAGSTR.xxx
  731. │(where xxx is the version of the used format, currently 201) is added
  732. │to the archive.
  733. │
  734. │Programs that will support this kind of tag-file are, MTS, RFW and
  735. │FileDoor itself. Other products can choose to use the functions of
  736. │such a tag-file.
  737.  
  738. │┌───────┬─────────────────────────────────────────────────────────────┐
  739. ││   5   │ Version information and credits                             │
  740. │└───────┴─────────────────────────────────────────────────────────────┘
  741. │
  742. │5.1 The BETA-team
  743. │────────────────────────────────────────────────────────────────────────
  744. │The following Sysop's and their CoSysop's (only if they use the same
  745. │BBS or a NON-user (closed) shadow BBS) are allowed to make use of the
  746. │BETA-releases on their own risk:
  747. │
  748. │- Remote Access Multiline/Multiport Paradise        2:512/100 (*)
  749. │  Sysop: Reinier De Groot
  750. │
  751. │- GOLEM Service BBS                                 2:242/4
  752. │  Sysop: Hanstheo Wolf
  753. │
  754. │- Sirex BBS                                         2:280/4   (HUB)
  755. │  Sysop: Gerry Ulrich                               2:280/401
  756. │
  757. │- Funboard BBS
  758. │  Sysop: Dirk Astrath                               2:244/12
  759. │
  760. │- Amber Shadow
  761. │  Sysop: Dave Overton                               1:203/988
  762. │
  763. │The BBS marked with (*) will always test the newest version and is
  764. │also the main distribution node for the MT-series. Also mail to me
  765. │can be send to this system. The other BBS's are asked, if they like,
  766. │to test the new versions, but if there is no time, or if they find
  767. │the risk to high I don't mind. I would be pleased though, if these
  768. │BBS's would like to look into the new BETA version.
  769. │
  770. │
  771. │5.2 Credits
  772. │────────────────────────────────────────────────────────────────────────
  773. │Thanks to the following people:
  774. │
  775. │- All registered users. You make it possible to enhance RFW with nice
  776. │  features;
  777. │- All users who did write me a message and/or sent me a postcard;
  778. │- The BETA-team;
  779. │- A special 'thanks' to Reinier de Groot, Hanstheo Wolf and
  780. │  Dirk Astrath. They keep coming with nice suggestions;
  781. │- A big thanks to Dave Overton who is doing the USA support;
  782.  
  783.  
  784.  5.3 Version history
  785.  ────────────────────────────────────────────────────────────────────────
  786.  ┌───────┬─────────────────────────────────────────────────────────────┐
  787.  │  1.01 │ Beta release                                                │
  788.  └───────┴─────────────────────────────────────────────────────────────┘
  789.   ■ First non-public beta release;
  790.  
  791.  ┌───────┬─────────────────────────────────────────────────────────────┐
  792.  │  1.02 │ Beta release                                                │
  793.  └───────┴─────────────────────────────────────────────────────────────┘
  794.   ■ First public beta release;
  795.  
  796.   ■ Changed the RFC.CMP into two files (RFC.CMP and RFC.ARE)
  797.     to gain memory;
  798.  
  799.   ■ Changed access to RFC.CMP, thus creating a gain in speed.
  800.     A benchmark with 5000 files in FILES.BBS under DesqView
  801.     gave the following results:
  802.  
  803.     1.01ß2  Stored in memory : 87.56 seconds
  804.     1.02ß4  Stored on DISK ! : 30.80 seconds
  805.  
  806.     A benchmark with 2000 files in FILES.BBS under DesqView
  807.     gave the following results:
  808.  
  809.     1.01ß2  Stored in memory : 37.67 seconds
  810.     1.02ß4  Stored in memory :  9.61 seconds
  811.  
  812.   ■ Fixed some extended ASCII traps, so ASCII (non ANSI)
  813.     users can now look at a clean screen;
  814.     Suggested by: Eddy Emck
  815.  
  816.   ■ Fixed name of program in program header (QFW was displayed
  817.     and not RFW).
  818.  
  819.  ┌───────┬─────────────────────────────────────────────────────────────┐
  820.  │  1.03 │ First public release                                        │
  821.  └───────┴─────────────────────────────────────────────────────────────┘
  822.  
  823.   ■ Added Hot-key support
  824.     Suggested by: Reinier de Groot, Eddy Emck, Gert Ensing and lots of
  825.                   other users I imagine;
  826.  
  827.   ■ RFW is now capable of displaying more than 24 lines if the user
  828.     did set a larger number of lines in the user-setup of the BBS;
  829.     Suggested by: Eddy Emck
  830.  
  831.   ■ It is now configurable to choose between clear-screen/display and
  832.     scrollwindow/display;
  833.     Reported by: Many users
  834.  
  835.   ■ It is now possible to let the 'TOF'/'BOF' rulers out of the list;
  836.     Reported by: Eddy Emck
  837.  
  838.   ■ It is now possible to configure all colors (local and remote);
  839.  
  840.   ■ It is now possible to configure the format the date that RFW displays
  841.     in the files-list;
  842.  
  843.   ■ You can replace the internal help-screen with your own files. While
  844.     displaying this file, Hot-key support is NOT active;
  845.     Suggested by: Eddy Emck
  846.  
  847.   ■ It is now possible (with a special configuration option, to keep
  848.     downward compatibility) to combine the /A option with all other
  849.     options to reduce the search/display to one area;
  850.     Suggested by: Eddy Emck
  851.  
  852.   ■ With keyword/file search any long comment (displayed on a next line
  853.     in a normal file-list) was not displayed and/or searched. This is
  854.     now fixed (in a somewhat cruel way).
  855.     Suggested by: Gert Ensing
  856.  
  857.   ■ The user can now force RFW to restart without loading itself again.
  858.     Suggested by: Eddy Emck
  859.  
  860.   ■ Fixed some bugs and flaws;
  861.  
  862.   ■ Fixed time-slice problems in DV. In combination with X00 (DV option)
  863.     there is no degradation in performance, even with 8 RFW's concurrent
  864.     in the machine;
  865.  
  866.   ■ Changed the internal structure of the compiled files again. This
  867.     gives you a gain of 3 bytes per line. You must run RFC again when
  868.     upgrading to this version !
  869.  
  870.  ┌───────┬─────────────────────────────────────────────────────────────┐
  871.  │  1.04 │ Bug release                                                 │
  872.  └───────┴─────────────────────────────────────────────────────────────┘
  873.  
  874.   ■ Changed the hotkey-support somewhat. Overrun errors should be fixed
  875.     now. Also several hits on ENTER or PGDN would result in a partial
  876.     displayed screen. This is also fixed;
  877.     Suggested by: Eddy Emck, Reinier de Groot
  878.  
  879.   ■ Fixed RFC to work OK on both the old structure of FILES.RA and the
  880.     one introduced with RA 1.00beta8.
  881.     Suggested by: Reinier de Groot
  882.  
  883.  ┌───────┬─────────────────────────────────────────────────────────────┐
  884.  │  1.10 │ Minor release                                               │
  885.  └───────┴─────────────────────────────────────────────────────────────┘
  886.   ■ Changed the hot-key support. RFW was know to eatup many ticks. This
  887.     was caused by the special routines that implemented the hot-keys.
  888.     All keys will now ALWAYS redraw the screen, so CRSR-DOWN when the
  889.     last line is on the screen will still cause a redraw of the screen.
  890.     The same goes for CRSR-UP, END, HOME, PGUP and PGDN. Hot-keys should
  891.     now work better and with a smaller number of cycles.
  892.     Suggested by: Eddy Emck
  893.  
  894.   ■ Added support for QuickBBS and SBBS;
  895.     Suggested by: Various users
  896.  
  897.   ■ Added support for CD-ROM drives in RFC;
  898.     Suggested by: Various users
  899.  
  900.   ■ Added /CFG to RFW and RFC and /ASC to RFW;
  901.  
  902.   ■ Added tag-file support to create and use FileDoor/DISP-compatible
  903.     tag-files;
  904.  
  905.   ■ Removed help information from RFW. This is now stored in a separate
  906.     help-file (example included);
  907.  
  908.   ■ Changed the FOSSIL-access a bit and changed the input-routines to
  909.     give back more time-slices to DesqView <tm>;
  910.  
  911.  
  912. │5.4 Copyright, Trademarks
  913. │────────────────────────────────────────────────────────────────────────
  914. │CRA           is a trademark of DISP and donated to public domain
  915. │Windows       is a trademark of The Microsoft Corporation
  916. │4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  917. │FrontDoor     is a trademark of J. Homrichhausen
  918. │QuickBBS      is a trademark of the QuickBBS group Inc.
  919. │Remote Access is a trademark of Continental Software
  920. │DesqView      is a trademark of QuarterDeck Office Systems.
  921. │X00           is a trademark of Ray Gwinn
  922. │
  923. │RFW is written in Turbo Pascal 6.0, with help of the Turbo Debugger 2.0
  924. │and makes extensive use of Object Professional 1.10 and OPCFI V 9.11.
  925. │
  926. │Turbo Pascal        is a trademark of Borland International
  927. │Turbo Debugger      is a trademark of Borland International
  928. │Object Professional is a trademark of TurboPower Inc.
  929. │OPCFI               is a trademark of Robert W. van Hoeven
  930. │
  931.  ==================== END OF DOCUMENT ==================================
  932.